home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 2 / MacMania 2.toast / Demo's / Tools&Utilities / Programming / Tools Plus 2.5 / Read Me First! next >
Encoding:
Text File  |  1994-05-23  |  12.6 KB  |  278 lines  |  [TEXT/ttxt]

  1.  
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.     FOR BEST RESULTS, OPEN THIS DOCUMENT USING A WORD PROCESSOR
  4.     AND DISPLAY IT USING A MONOSPACED FONT, SUCH AS MONACO 9.
  5.  
  6. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  7.  
  8.  
  9. What is “Tools Plus”
  10. ````````````````````
  11.   Tools Plus is a set of powerful, yet easy-to-learn productivity libraries for Macintosh programmers using Symantec Corporation’s THINK C/C++, and THINK Pascal.  Over 170 high-powered “set and forget” routines let you create your application’s user interface, while Tools Plus maintains it for you and takes care of event management.
  12.  
  13.   With Tools Plus, you have the advantage of enhanced functionality, automation, and full integration of: windows, floating palettes, tool bar, cursors, buttons, picture buttons, scroll bars, editing fields, list boxes, pull-down and hierarchical menus, pop-up menus, the Edit menu, clipboard, alerts, event handling, and more.  Once you create your user interface, Tools Plus makes it work.  Virtually all Tools Plus routines can be executed with a single line of code.
  14.  
  15.   Using Tools Plus simplifies your programming and accelerates development.  You’ll create applications in less time, with less source code, with far fewer bugs, and with more features than if you use ordinary C/C++ or Pascal.
  16.  
  17.   Tools Plus libraries can be compiled into applications intended for System 5 and 6 (running under Finder and MultiFinder™), and System 7.
  18.  
  19.  
  20.   Tools Plus is explained in greater detail in chapter 1 (Introduction) of the User Manual.  For a summarized list of benefits and features, please refer to the following documents:
  21.       Read Me! Advantage Tools Plus
  22.       Read Me! Key Features
  23.  
  24.  
  25.  
  26. If you decide to register Tools Plus, you will receive:
  27.    √ the latest version of Tools Plus
  28.    √ a comprehensive, illustrated 250-page user manual
  29.    √ free technical support
  30.    √ free software updates
  31.    √ software upgrades at reduced prices
  32. and you may distribute programs created with Tools Plus royalty-free.
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39. MINIMUM Requirements to Develop Applications using Tools Plus
  40. `````````````````````````````````````````````````````````````
  41. • Macintosh Plus computer
  42. • System 6.0.4 
  43. • THINK C 5.0.1 or later         or
  44.   Symantec C/C++ 6.0.1 or later  or
  45.   Symantec C/C++ 7.0 or later    or
  46.   THINK Pascal 4.0.2 or later
  47. • 1 MB RAM (2 MB with System 7)
  48. • Hard disk (for THINK C/C++ or THINK Pascal)
  49.  
  50.  
  51.  
  52.  
  53. MINIMUM Requirements to Run Applications Written With Tools Plus
  54. ````````````````````````````````````````````````````````````````
  55. • Macintosh 512KE computer
  56. • System 5.0*
  57. • 64K RAM (for application)
  58. • Floppy disk drive
  59.  
  60. *Tools Plus takes advantage of System 7’s features, but you can
  61.  compile Tools Plus libraries into applications intended to run
  62.  on System 5, 6 or System 7.
  63.  
  64.  
  65.  
  66.  
  67.  
  68. Shareware
  69. `````````
  70. This fully featured copy of Tools Plus is distributed at no cost as Shareware.  The purpose of this is to allow potential users to EVALUATE the software before buying it.  There are, however, terms and conditions to using this product, even for the purpose of evaluation.
  71.  
  72.   Tools Plus is also available as a “fully registered” product for a registration fee.  Registration entitles you to special privileges and benefits that are not offered to unregistered users.
  73.  
  74.   For full details, please read the “ShareWare License & Legal Info” document.
  75.  
  76.  
  77.  
  78.  
  79.  
  80. What Is Shareware?
  81. ``````````````````
  82.   “Shareware” is a method of software distribution that gives users an opportunity to try software before buying it.  If you try a Shareware program and continue using it, you are expected to register.  Details vary for individual programs: some request registration while others require it.  Some specify a maximum trial period.  With registration, you get anything from the simple right to continue using the software, to an updated program with printed manual.
  83.  
  84.   Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights with a few specific exceptions as specifically stated.  Like commercial authors, Shareware authors are accomplished programmers, and their programs are of comparable quality (in both cases, there are good programs and not-so-good programs).  The main difference is in the method of distribution. The Shareware author specifically grants the right to copy and distribute the software, either to anyone or to a specific group.  Some authors, for example, require written permission before a commercial disk vendor may copy their software.
  85.  
  86.   Shareware is a method of distribution, not a type of software. You should always buy software that suits your requirements and budget, regardless if it’s commercial or Shareware.  The Shareware system makes it easier to determine if the software suits your needs, because you can try it before you buy it.  Furthermore, since the Shareware author’s overhead is low, prices are generally low as well.  Shareware has the ultimate money-back guarantee: if you don’t use the product, you don’t pay for it!
  87.  
  88.  
  89.  
  90.  
  91.  
  92. Tools Plus Documentation
  93. ````````````````````````
  94.   The “evaluation” documentation that is included with this copy of Tools Plus is extensive, but well organized and easy to follow.  It has, however, been edited to (a) reduce its size to facilitate electronic transfer, and (b) to allows users to read the files regardless of their brand and version of word processor.  As a result, this documentation does not include, pictures, illustrations, programming tips, or an index.  If you choose to register your copy of Tools Plus, you will receive a comprehensive 250 page professionally illustrated, indexed and bound Tools Plus User Manual.
  95.  
  96.   For the best viewing results, please open the Tools Plus documentation by first launching your word processor, then use the File menu’s Open command to open the desired document.  Display the document using a monospaced font (Monaco 9pt is recommended).  As a last resort, if you do not have a word processor, you can double-click any of the documents and TeachText (a free application from Apple that comes with each set of System disks) will display them.
  97.  
  98.  
  99.  
  100.  
  101.  
  102. Tools Plus Documentation - Chapters
  103. ```````````````````````````````````
  104.   The Tools Plus User Manual can be found as a number of documents in the “User Manual” folder.  Each document in the “User Manual” folder is a single chapter of the User Manual.  If you view the folder by name, you will see the documents sorted by chapter number (because the document’s name starts with the chapter number).
  105.   TeachText has a file limit of 32k (as do some low-end text processors), so chapters that exceed that limit have been split into several files (suffixed with “1 of 2” and “2 of 2” etc.)
  106.   The following is a summary of the User Manual’s chapters:
  107.  
  108.   “ShareWare License & Legal Info”
  109.        • Copyright and trademark information
  110.        • An explanation of Shareware
  111.        • Software License and Warranty
  112.        • Registration information
  113.  
  114.   “00-Contents”
  115.        • User Manual’s table of contents
  116.  
  117.   “01-Introduction”
  118.        • What is Tools Plus
  119.        • An Overview of Tools Plus
  120.        • The advantages of using Tools Plus
  121.        • Who can benefit from Tools Plus
  122.        • What kind of applications can be written with Tools Plus
  123.        • What is Tools Plus not suitable for
  124.        • System Requirements (computer, system, memory, disk, etc.)
  125.        • Tools Plus Source Code and Site Licensing
  126.        • Before You Start Programming
  127.        • If you are new to Macintosh programming
  128.  
  129.   “02-Installing Tools Plus”
  130.        • Installation instructions describing how to install Tools Plus
  131.          in your THINK C/C++ project, or THINK Pascal project.
  132.        • How to compile the demo application included with Tools Plus
  133.  
  134.   “03-Designing Your Application”
  135.        • How to design your application to work with Tools Plus
  136.        • Overview of Macintosh events vs Tools Plus events
  137.        • The main event loop
  138.        • Differences in Finder, MultiFinder and System 7
  139.  
  140.   “04-Initializing Tools Plus”
  141.        • How to initialize the Tools Plus libraries before using them
  142.  
  143.   “05-Windows (1 of 2)”
  144.   “05-Windows (2 of 2)”
  145.        • Explanation of windows’ features
  146.        • Creating and using windows in your application
  147.        • Creating and using a tool bar in your application
  148.        • Creating and using floating palettes in your application
  149.  
  150.   “06-Buttons”
  151.        • Explanation of buttons’ features
  152.        • Creating and using buttons in your application (includes push-
  153.          buttons, radio buttons and check-boxes)
  154.  
  155.   “07-Picture Buttons (1 of 3)”
  156.   “07-Picture Buttons (2 of 3)”
  157.   “07-Picture Buttons (3 of 3)”
  158.        • Explanation of picture buttons’ features
  159.        • Creating and using picture buttons in your application
  160.  
  161.   “08-Scroll Bars”
  162.        • Explanation of scroll bars’ features
  163.        • Creating and using scroll bars in your application
  164.  
  165.   “09-Editing Fields (1 of 2)”
  166.   “09-Editing Fields (2 of 2)”
  167.        • Explanation of editing fields’ features
  168.        • Creating and using editing fields in your application
  169.  
  170.   “10-List Boxes”
  171.        • Explanation of list boxes’ features
  172.        • Creating and using list boxes in your application
  173.  
  174.   “11-Pop-Up Menus (1 of 2)”
  175.   “11-Pop-Up Menus (2 of 2)”
  176.        • Explanation of pop-up menu’ features
  177.        • Creating and using pop-up menus in your application
  178.  
  179.   “12-Menus (1 of 2)”
  180.   “12-Menus (2 of 2)”
  181.        • Explanation of menus’ features
  182.        • Creating and using pull-down menus in your application
  183.        • Creating and using hierarchical menus in your application
  184.  
  185.   “13-Cursors”
  186.        • Explanation of cursor features
  187.        • Automatic cursor changes (cursor tables and zones)
  188.        • Cursor animation
  189.        • Creating and using cursors in your application
  190.  
  191.   “14-System Polling (1 of 4)”
  192.   “14-System Polling (2 of 4)”
  193.   “14-System Polling (3 of 4)”
  194.   “14-System Polling (4 of 4)”
  195.        • Explanation of Tools Plus’s automatic processes
  196.        • Polling for events (the main event loop)
  197.        • Tools Plus events vs Macintosh Toolbox events
  198.        • Responding to Tools Plus events
  199.  
  200.   “15-Color Drawing/Multi Screens”
  201.        • Programming for Macs that have several monitors
  202.        • Color-dependent drawing (drawing that changes depending on the
  203.          monitor’s settings, such as: [1] color, gray or B&W, [2] number
  204.          of colors or grays)
  205.  
  206.   “16-User Notification”
  207.        • Explanation of User Notification features
  208.        • Setting and triggering User Notification in your application
  209.  
  210.   “17-Dynamic Alerts”
  211.        • Explanation of Dynamic Alerts’ features
  212.        • Creating and using Dynamic Alerts in your application
  213.  
  214.   “18-Miscellaneous Routines”
  215.        • Several Macro routines that perform commonly used tasks, such
  216.          as drawing icon families, drawing “zoom lines”, and drawing the
  217.          standard progress thermometer.
  218.  
  219.   “19-Other Macintosh Features”
  220.        • Creating and using the Macintosh toolbox’s alerts and dialogs,
  221.          custom controls, and list manager.
  222.  
  223.   “20-Memory”
  224.        • List of Tools Plus routines that consume memory, and details as
  225.          to how much memory.
  226.  
  227.   “21-Font Heights”
  228.        • List of commonly used fonts and their heights
  229.  
  230.   “22-Special Routines”
  231.        • Macintosh toolbox routines that should be used with caution or
  232.          not at all.
  233.        • Substitute Tools Plus routines are listed where the toolbox’s
  234.          routines should not be used.
  235.  
  236.   “23-Completing Your Application”
  237.        • Finishing touches needed to complete an application written
  238.          with Tools Plus.  Most of this is similar to ordinary Macintosh
  239.          applications (i.e. the SIZE resource, the application’s icon
  240.          family, the BNDL resource, etc.)
  241.  
  242.   “24-Technical Support & Updates”
  243.        • How Water’s Edge Software technical support can help you
  244.        • Free software updates and upgrades
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251. P L E A S E   R E A D ....
  252. ``````````````````````````
  253. Please read the “ShareWare License & Legal Info” document.  It grants you to specific rights, and defines the limits of use of this Shareware software.
  254.    Also, please read the User Manual (“glancing” through it doesn’t count).
  255.  
  256.  
  257.  
  258.  
  259.  
  260. Feedback
  261. ````````
  262. In the interest of providing you with the best possible product, we invite you to tell us your opinions about Tools Plus... even if you are not a registered user.
  263.    Tell us what you like, what you don’t like, and let us know what features you would like to see in future releases.  Please send your feedback to the CompuServe address listed below: 
  264.  
  265.    73424,2507
  266.  
  267. If you are using AppleLink or another e-mail system, you likely have access to Internet.  Water’s Edge Software can be contacted at the following Internet account:
  268.  
  269.    73424.2507@compuserve.com
  270.  
  271. Please check your e-mail User Manual, or contact your e-mail Customer Service representative for information on accessing Internet accounts.
  272.  
  273.  
  274.  
  275.  
  276.  
  277. E N J O Y !
  278.